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Preface 


Intended Audience 

This manual is intended for all system users. 


Structure of This Document 

This document is composed of four major sections. 

The Format Section is an overview of the Sort/Merge Utility and is intended 
as a quick reference guide. The format summary contains the DCL command 
that invokes the Sort/Merge Utility, listing all command qualifiers and 
parameters. The usage summary describes how to invoke and exit from the 
Sort/Merge Utility, how to direct output, and any restrictions you should be 
aware of. 


The Description Section explains how to use the Sort/Merge Utility. 


The Qualifier Section describes each DCL command qualifier. Qualifiers 
appear in alphabetical order. 


The Examples Section contains examples of common operations that you 
perform with the Sort/Merge Utility. 


Associated Documents 

To use the Sort/Merge Utility, you should also be familiar with the following 
manuals: 


Introduction to VAX/VMS 
VAX/VMS DCL Dictionary 


Conventions Used in This Document 


The following conventions are observed in this manual: 


Convention Meaning 

I RET | A symbol with a one- to three-character 

abbreviation indicates that you press a key on 
the terminal, for example, |RET| . 

1ctrl/x| The phrase CTRL/x indicates that you must press 

the key labeled CTRL while you simultaneously 
press another key, for example, CTRL/C, CTRL/Y, 
CTRL/O. 
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Preface 


Convention 

Meaning 

$ SHOW TIME 

05-JUN-1982 11:55:22 

Command examples show all output lines or 
prompting characters that the system prints 
or displays in black letters. All user-entered 
commands are shown in red letters. 

$ TYPE MYFILE.DAT 

Vertical series of periods, or ellipsis, mean either 
that not all the data that the system would display 
in response to the particular command is shown or 
that not all the data a user would enter is shown. 

file-spec,... 

Horizontal ellipsis indicates that additional 
parameters, values, or information can be entered. 

[logical-name] 

Square brackets indicate that the enclosed item 
is optional. (Square brackets are not, however, 
optional in the syntax of a directory name in a 
file specification or in the syntax of a substring 
specification in an assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer to 
double quotation marks ("). The term apostrophe 
(') is used to refer to a single quotation mark. 
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New and Changed Features 


The following enhancements are included in this version of the Sort/Merge 
Utility: 

• Faster performance—2 to 4 times faster 

• Greater capacity—uses less memory, less scratch file space 

• Packaged as a shareable image 

• Up to 255 keys supported 

• Equal-key deletion 

• MULTINATIONAL collating sequence supported 

• New specification file format 

• Specification file translator 

• Improved error diagnosis 









SORT 


SORT 


VAX/VMS Sort Utility sorts records from one or more input files 
according to the field(s) you select and generates one reordered 
output file. VAX/VMS Merge Utility merges up to 10 input files that 
have previously been sorted according to the same key field(s) and 
generates one output file. 


SORT SORT input-file(s) output-file 

FORMAT _ 


Command Qualifiers 

Defaults 

/COLLA TING—SEQUENCE=sequence 

/COLLA TING—SEQUENCE=ASCII 

/[NO]DUPLICATES 

/DUPLICATES 

/KEY=(field [,...]) 

See text. 

/PROCESS=type 

/PROCESS=RECORD 

/SPECIFICA TION=file-spec 

See text. 

/[NOJSTABLE 

/NOSTABLE 

/[NOJSTA TISTICS 

/NOSTATISTICS 

/WORK—FILES[=n] 

/WORK—FILES=2 

Input-file Qualifier 

Default 

/FORMA T=(file-attribute [,...]) 

None. 

Output-file Qualifiers 

Defaults 

/ ALLOCATION =n 

None. 

/BUCKET—SIZE=n 

None. 

/CONTIGUOUS 

None. 

/FORMA T=(record-format .]) 

None. 

/INDEXED—SEQUENTIA L 

None. 

/OVERLAY 

None. 

/RELATIVE 

None. 

/SEQUENTIAL 

None. 
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Description 


MERGE 

FORMAT 


usage summary 


MERGE input-files output-file 


Command Qualifiers 

Defaults 

/[NOJCHECK—SEQUENCE 

/CHECK-SEQUENCE 

/COLLA TING—SEQUENCE=sequence 

/COLLA TING—SEQUENCE=A SCII 

/[NOJDUPLICA TES 

/DUPLICATES 

/KEY=(field [,...]) 

See text. 

/SPECIFICA TION=file-spec 

See text. 

/[NOJSTABLE 

/NOSTABLE 

/[NOJSTA TISTICS 

/NOSTATISTICS 

Input File Qualifiers 

/FORMAT=(file-attribute [,...]) 

Default 

None. 

Output File Qualifiers 

/ ALLOCATION=n 

Defaults 

None. 

/BUCKET—SIZE=n 

None. 

/CONTIGUOUS 

None. 

/FORMA T=(record-format [,...]) 

None. 

/INDEXED—SEQUENTIAL 

None. 

/OVERLAY 

None. 

/RELATIVE 

None. 

/SEQUENTIAL 

Command Parameters 

input-file(s) 

None. 

Specifies the files to be merged. Up to ten files, presorted by the same key(s), 
may be specified. Multiple file specifications must be separated by commas. 

The default file type is DAT. 
output-file 


Specifies the merged file to be created. Only one output file may be specified. 
If you omit a file type in the file specification, MERGE defaults to the file type 

of the first input file. 



Invoking 

The SORT command invokes the VAX/VMS Sort Utility. The MERGE 
command invokes the VAX/VMS Merge Utility. 

Exiting 

After completing the operation, the Sort/Merge Utility exits and returns the 
user to DCL command level. 

Directing Output 

You specify where you want the results of the SORT/MERGE operation with 
the output file parameter. 

Privileges/Restrictions 

None. 
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Description 


DESCRIPTION The VAX/VMS Sort Utility (SORT) sorts records from one or more input files 

according to the field(s) you select and generates one reordered output file. 
The VAX/VMS Merge Utility (MERGE) merges up to ten input files that have 
previously been sorted according the the same key field(s) and generates one 
output file. 


1 Sort Utility 

SORT arranges records from an input file(s) according to the key(s) you 
specify. The records can be arranged in ascending or descending, alphabetic 
or numeric order depending on how the key is described. For example, each 
record in the file, NAMES.DAT, consists of two fields—a customer name field 
and an account number field. The customer name field begins in the first 
byte of the record, is 13 letters long, and contains character data; the account 
number field begins in position 16 of the record, is 5 digits long, and contains 
decimal data. 


NAMES.DAT 

Customer Name Account Number 
(1-13) (16-20) 


I McKee Michael 643881 
I Erickson Sam 729311 
I Wilson Brent 166391 
iCoolidge Sue 980341 
I Rice Anne 753731 


To create a new file, BILLING.LIS, with the records from NAMES.DAT 
arranged by account number, you must decribe the account number key field 
with the /KEY qualifier. 

The /KEY qualifier specifies the following information: 

• Position of the key in a record 

• Size of the key 

• Data type of the key 

• Order of the sort operation 

In addition to describing the key field, you must also pass SORT the input file 
specification, followed by the output file specification. The following SORT 
command sorts the input file, NAMES.DAT, according to the account number 
key field and creates the output file, BILLING.LIS: 

$ SORT /KEY=(POSITION:16.SIZE:5.DECIMAL) NAMES.DAT BILLING.LIS 


NAMES.DAT 


BILLING. 

LIS 

1 McKee Michael 

64388 I 

iWilson Brent 

166391 

1 Erickson Sam 

729311 “= 

=-> 1 McKee Michael 

64388| 

1 Wilson Brent 

166391 

1 Erickson Sam 

72931| 

ICoolidge Sue 

98034| 

IRice Anne 

75373| 

iRice Anne 

753731 

ICoolidge Sue 

98034| 


By default SORT assumes a key field that 

• Begins in the first position of a record 

• Includes the entire record 
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Description 


• Contains character data 

• Will be sorted in ascending order 


To create an output file, BILLING.LIS, with the records ordered alphabetically 
by customer name, you would use the customer name field as the key. 
Because entire records will be sorted and the customer name key contains 
character data that begins in the first position of the record, you do not 
need to describe the key. You need only pass the input and output file 
specifications, as in the following command: 

$ SORT NAMES.DAT BILLING.LIS 

Note that whenever you sort on a key field that is different from the default, 
you must describe that key field with the /KEY qualifier. For more details 
concerning keys, see the description of the /KEY qualifier. 


Multiple Keys 

You may sort with more than one key. Multiple keys must be specified in the 
order of their priority, the primary key specified first, the secondary key next 
and so on. For example, NAMES.DAT is sorted first on the account number 
key and then by the customer name key with the following command: 

$ SORT /KEY=(POSITION:16.SIZE:5,DECIMAL) - 
_$ /KEY=(P0SITI0N:1,SIZE:16.CHARACTER) NAMES.DAT BILLING.LIS 


Equal Keys 

If two or more records have equal key fields, the order of those records in 
the output file is unpredictable. By specifying the /STABLE qualifier, you 
can maintain the input order of the records. If two or more records have 
equal fields and if you want to retain only one of the records, specify the 
/NODUPLICATES qualifier. /STABLE and /NODUPLICATES cannot be 
specified on the same command line. For more details, see the description of 
the /STABLE and /NODUPLICATES qualifiers. 


Output File Organization 

By default, the output file has the same organization as that of the first input 
file. If the organization of the output file is to differ from that of the input file, 
you must specify the appropriate qualifier after the output file specification on 
the command line. 


Qualifier 

Purpose 

/FORMAT 

/INDEXED-SEQUENTIAL 

/RELATIVE 

/SEQUENTIAL 

Specifies record format 

Specifies indexed-sequential file organization 
Specifies relative file organization 

Specifies sequential file organization 
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Description 


For more details, see the descriptions of these qualifiers. 


Sorting Process 

SORT arranges files by the following processes: 

• Record 

• Tag 

• Address 

• Indexed 

By default, SORT arranges files by a record process that keeps records intact 
when sorting them and produces an output file of complete records. To 
specify a sorting process, use the /PROCESS qualifier. For a comparison 
of the record, tag, address, and indexed processes, see the /PROCESS 
description in the Command Qualifiers Section. 

The /PROCESS qualifier can be used only with SORT; you cannot specify a 
process for MERGE. 


Merge Utility 

The Merge Utility combines up to ten sorted files into one ordered output file. 
All the input files must have the same format and must have been sorted on 
the same key field(s). 

For example, BILLING1.LIS and BILLING2.LIS, sorted on the same key, are 
merged to create one output file MAILING.LIS, which contains all the records 
from both files. The following MERGE command, containing the input and 
output file specifications, creates the output file MAILING.LIS: 

$ MERGE BILLING1.LIS,BILLING2.LIS MAILING.LIS 
BILLINGl.LIS 


1Coolidge Sue 

98034| 

lErickson Sam 

72931| 

I McKee Michael 

64388 I 

BILLING2.LIS 

1 Brown Thomas 

235811 

1 Waters Mary 

44567| 

IWoo Lee 

99807| 


MAILING.LIS 


I Brown Thomas 235811 
ICoolidge Sue 98034 I 
I Erickson Sam 729311 
I McKee Michael 643881 
I Waters Mary 445671 
I Woo Lee 998071 


A merge operation is specified in the same way as a sort operation with two 
exceptions: 

• You may not specify a process for a merge operation. 

• The /CHECK—SEQUENCE qualifier is used only for a merge operation. 

By default, MERGE checks the order of the records. If any records are out of 
order, a diagnostic message will be issued and processing will continue. 
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Description 


3 Collating Sequence 

SORT/MERGE arranges character data according to the following collating 
sequences: 

• ASCII 

• EBCDIC 

• MULTINATIONAL 


By default, SORT arranges character data according to the ASCII collating 
sequence. When SORT collates data according to the EBCDIC sequence, 
the output file is arranged according to the EBCDIC sequence, but the data 
remains in ASCII representation. The MULTINATIONAL sequence collates 
the international character set and treats uppercase and lowercase letters in a 
different manner than the ASCII collating sequence. 

See the /COLLATING—SEQUENCE description in the Command Qualifiers 
Section for more information on the ASCII, EBCDIC, and MULTINATIONAL 
collating sequences. 

You may also define your own collating sequence or modify any of the 
three collating sequences through the use of a specification file. See the 
/COLLATING—SEQUENCE description in the Specification File Qualifiers 
Section. 


4 SORT /MERGE Specification File 

A SORT/MERGE specification file allows you to specify instructions that will 

• Select records to be included in the sort/merge operation 

• Reformat the records in the output file 

• Use conditional keys or data 

• Specify multiple record formats 

• Create or modify a collating sequence 

• Reassign work files 

• Use frequently used sort/merge operations 


You use a text editor to create a specification file. Many of the qualifiers used 
in the specification file are similar to the DCL qualifiers used in the command 
line; however, additional qualifiers are supported in the specification file. 
Each of the qualifiers is explained in detail in the Specification File Qualifiers 
Section. 

Generally, there is no required order in which you must specify the qualifiers 
in a specification file. The order does become significant, however, when 
you are sorting on more than one key field, when you are describing the 
output format, and when you are defining multiple record types. When 
you specify the FOLD, MODIFICATION, and IGNORE keywords with 
the /COLLATING-SEQUENCE, you should specify all MODIFICATION 
and IGNORE clauses before any FOLD clauses. See the /COLLATING- 
SEQUENCE description in the Specification File Qualifiers Section for more 
details. 
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Description 


You may include comments in your specification file by beginning each 
comment line with an exclamation point. 

After you create the text of the specification file, pass the file name with the 
/SPECIFICATION qualifier. The default file type for a specification file is 
SRT. 

Any DCL command qualifiers on the command line that you specify will 
override any corresponding entries in the specification file text. For example, 
if you specify any /KEY qualifier in the DCL command line, SORT/MERGE 
will ignore all /KEY, /DATA, /INCLUDE, and /OMIT clauses in the 
specification file text. 


4.1 Converting Version 3 Specification Files 

You can convert specification files that used the format of previous versions of 
SORT/MERGE by using the sort translation utility. First, define the symbol 
SORTTRANS with the following: 

$ SORTTRANS :== "$SYS$SYSTEM:SRTTRN" 

Then specify the following command line: 

$ SORTTRANS input-file/Snn output-file 

The input-file parameter specifies the name of the specification file from a 
previous version (Version 3 or earlier). The /Snn qualifier specifies which 
type of specification file is being converted. Old SORT-32 specification files 
are specified as /S32; old PDP-11 specification files are specified as /Sll. By 
default, SORTTRANS assumes the /Sll qualifier. 

The output-file parameter specifies the name of the specification file that the 
translator utility created with the new format. There is no default file type for 
the input file; the default for the new output specification file is SRT. 

The translator utility includes the specifications from the old format in the 
file with the new format, setting them off with comment markers. Any errors 
found during the conversion of the old specification file are displayed on 
SYS$OUTPUT. 


4.2 Entering Terminal Input 

If you want to provide input to SORT interactively on a terminal, specify 
SYS$INPUT as the input file, qualifying it with the size of the longest record 
(in bytes) and the approximate size of the input file (in blocks). After you 
enter the command, enter the input records. Terminate each record by 
pressing RETURN, and terminate the file by pressing CTRL/Z. For example: 

$ SORT /KEY=(POSITION:8.SIZE:20)_ 

_$ SYS$INPUT /F0RMAT=(REC0RD_SIZE=27, FILE_SIZE=10) NE.LST 
B 2376 FRENCH MARILYN 
V 3899 ROSE JACK 


♦EXIT* 

This sequence of commands creates the output file NAME.LST, which 
contains the sorted records. 
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Description 


Batch SORT/MERGE Job 

You can run a sort or merge operation as a batch job, freeing your terminal 
for other work. Create a DCL command procedure containing the sort and/or 
merge commands. Execute the procedure by using the SUBMIT command. 
See the VAX/VMS DCL Dictionary for more information concerning batch 
jobs. 


Optimization 

If you are dissatisfied with the efficiency of your sort or merge operation, 
you can investigate a number of possibilities to increase efficiency. First, 
you should evaluate the variables in your sorting environment by using the 
/STATISTICS qualifier. After you examine the statistics display, consider any 
of the optimization options presented below. 


User Optimization Options 

You may improve SORT efficiency by using a specification file. 
/CONDITION, /INCLUDE, and /OMIT clauses can be used to include 
only those records needed in the output file. Specification file clauses can 
also be used to reformat records to omit unnecessary fields from the output 
records. 

See the Specification File Qualifiers Section for more details. 


Assigning Work Files To Different Devices 

You can also increase SORT efficiency by assigning the location of the work 
files to random-access, mass-storage devices, such as disks. Normally, SORT 
places work files in the directory SYS$SCRATCH. However, placing work 
files on separate disk-structured devices permits overlap of SORT'S read/write 
cycle. For greatest sorting efficiency, you can place work files on 

• The fastest device(s) available 

• The device(s) having the least activity 

• The device(s) having the most space available 

• Separate devices 

At DCL level, you can select a different device for any work file by specifying: 

$ ASSIGN device: SORTWORKn 

SORTWORKn is a logical name for the work file, where n indicates the 
number of the work file. Acceptable values are 0 through 9. For example, 
when you specify /WORK_FILES=3, use SORTWORKO, SORTWORK1, and 
SORTWORK2 in assigning these three work files to other devices. 

You may also use the /WORK_FILES clause of the specification file to assign 
work files. 
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Description 


5.3 



Working Set Extent 

For the sort phase, SORT allocates enough memory to hold the input file, but 
not more than the working set extent. During the sort phase, records are read 
into this memory until it is full. If the memory cannot hold all the records, 
SORT transfers sorted strings to a work file on a temporary storage device. 

When a sort operation uses work files, as in most sorts of large files, a larger 
working set increases sort efficiency. The larger the sort data structure, the 
greater chance SORT has of creating longer and fewer sorted strings in the 
work file. Fewer strings mean fewer merge passes and a faster sort. 

Sometimes less memory is desirable. If the system is heavily used, VAX/VMS 
may be unable to allocate all the pages in the working set extent to your 
process. To avoid excessive paging in a heavily used system, you could make 
the working set extent lower. A better method is to misstate the allocated 
size of the input file with the /FORMAT=(FILE_SIZE:n) qualifier to a value 
slightly less that the working set extent that you expect your process will 
receive. This method causes SORT to underestimate its memory needs, use 
less memory, and take fewer page faults on a heavily used system. 
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SORT Optimization Qualifiers 


The Sort Utility provides the following qualifiers that will enable you to 
optimize your sort operation: 


/STATISTICS 

/ALLOCATION 

/CONTIGUOUS 

/BUCKET_SIZE 

/FORMAT 

/WORK_FILES 

/PROCESS 


Displays a statistical summary 
Allocates space for output file 

Allocates contiguous space for output file when used with 
/ALLOCATION 

Specifies bucket size 

Specifies input file size or output file format 
Sets the number of work files 
Specifies a different sorting process 


Each of these qualifiers is explained in the Command Qualifiers Section. 



System Manager Optimization Options 

One way the system manager can improve SORT'S efficiency is to designate 
one batch queue for sorting jobs, and to give this queue a very large working 
set quota. 

In addition, job process parameters can be adjusted for greatest SORT 
efficiency. The values recommended below are based solely on SORT 
considerations; the system manager should integrate other system 
considerations with these to determine appropriate values. 

• Working set extent per process (WSEXTENT and WSAUTHEXT)—For 
maximum sorting efficiency, this value should be set to the largest value 
any sorting job would ever need. Generally, the smaller the working set, 
the slower the sort. For very large files, working sets of 500 to 1000 pages 
are not at all unreasonable, provided the system has enough physical 
memory to support them. To prevent users from monopolizing real 
memory, the system manager can set individual maximums on a per-user 
basis through the authorization file. 
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• Virtual page count per process (VIRTUALPAGECNT)—For maximum 
sorting efficency, this parameter should be set to at least 1000 pages more 
than the maximum working set extent. Although SORT limits the size 
of the sort data structure to the process's working set extent, if work files 
are required, SORT can use the extra memory for I/O buffers. If this 
parameter is too low relative to the working set extent, SORT may be 
unable to create buffers for the work files when the files cannot be sorted 
in memory. 
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Command Qualifiers 


COMMAND 

QUALIFIERS 


This section describes the qualifiers to the SORT and MERGE commands. 
These qualifiers enable you to define your key fields, to describe the data in 
those fields, and to specify various SORT options. 
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/CHECK-SEQUENCE 


/CHECK-SEQUENCE 

Verifies the sequence of the records in MERGE input files. By 



default, the Merge Utility checks the sequence of records. 

FORMAT 

/[NO]CHECK_SEQUENCE 

DESCRIPTION 

The /CHECK__SEQUENCE qualifier is unique to MERGE. By default, MERGE 
does sequence checking to ensure that the input files have been sorted on the 
same key. 

You can also use the /CHECK-SEQUENCE qualifier to check that the records 
of one or more files (up to 10) have been sorted. (The records will still be 
directed to an output file, which you must specify.) If you are checking 
that records are sorted on a key field other than the entire record, you must 
specify key information, along with requesting sequence. 


EXAMPLES 

□ $ MERGE/KEY=(SIZE:4,POSITION:3)/NOCHECK.SEQUENCE PRICE1.DAT- 

PRICE2.DAT PRICE.LIS 

The /NOCHECK—SEQUENCE qualifier specifies that sequence of the input 
files, PRICE1.DAT and PRICE2.DAT, need not be checked because the 
records in those files were sorted on the same key and the sequence of 
records is correct. 

0 $ MERGE/SPECIFICATION=PAYROLL.SRT/CHECK_SEQUENCE - 

_$ MAY3.DAT,MAY10.DAT,MAY17.DAT,MAY24.DAT TOTAL.LIS 

Because the specification file, PAYROLL.SRT, specifies no sequence checking, 
the /CHECK_SEQUENCE qualifier on the MERGE command line is 
necessary to override that instruction. The sequence of records in the four 
input files will be checked. 
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/COLLATING-SEQUENCE 


/COLLATING-SEQUENCE 

Selects one of three predefined collating orders for character key 
fields. SORT arranges characters in ASCII sequence by default; the 
EBCDIC and MULTINATIONAL sequences may also be used. 


FORMAT /COLLATING_SEQUENCE=fype 


qualifier values ASCII 

Arranges characters according to ASCII sequence. ASCII is the default 
sequence and need not be specified. 

EBCDIC 

Arranges characters according to EBCDIC sequence. The characters remain in 
ASCII representation; only the order is changed. 

MULTINATIONAL 

Arranges characters according to MULTINATIONAL sequence, which collates 
the international character set. When you use the MULTINATIONAL 
sequence, characters are ordered according to the following rules: 

• All diacritical forms of a character are given the collating value of the 
character (A', A", A collate as A). 

• Lowercase characters are given the collating value of their uppercase 
equivalents (a collates as A, a" collates as A"). 

• If two strings compare as equal, tie-breaking is performed. The strings are 
compared to detect differences due to diacritical marks, ignored characters, 
or characters that collate as equal although they are actually different. If 
the strings still compare as equal, another comparison is done based on 
the numeric codes of the characters. In this final comparison, lowercase 
characters are ordered before uppercase. 

Care should be taken when sorting or merging files for further processing 
using the MULTINATIONAL sequence. Sequence checking procedures 
in most programming languages compare numeric characters. Because 
MULTINATIONAL is based on actual graphic characters, and not the codes 
representing those characters, normal sequence checking will not work. 

Note that some languages do not support MULTINATIONAL comparisons 
and instead can use the LIB$ COMPARE-MULTI routine. 


DESCRIPTION By default, SORT/MERGE arranges records according to ASCII sequence. 

SORT will also arrange records according to EBCDIC and MULTINATIONAL 
sequence. 

These three collating sequences may be modified to meet your particular 
needs through the use of a specification file. You may also define your own 
collating sequence by using a specification file if one of the three collating 
sequences does not suit your needs. See the description of the specification 
file for more detail. 


SORT-13 










SORT 

/COLLATING-SEQUENCE 


Table SORT-1 DEC Multinational Collating Sequence 


HEX 

Code 

Octal 

Code 

Decimal 

Code 

Char or 
Abbrev. 

Description 

00 

000 

000 

NUL 

Null character 

01 

001 

001 

SOH 

Start of heading 

02 

002 

002 

STX 

Start of text 

03 

003 

003 

ETX 

End of text 

04 

004 

004 

EOT 

End of transmission 

05 

005 

005 

ENQ 

Enquiry 

06 

006 

006 

ACK 

Acknowledge 

07 

007 

007 

BEL 

Bell 

08 

010 

008 

BS 

Backspace 

09 

Oil 

009 

HT 

Horizontal tabulation 

0A 

012 

010 

LF 

Line feed 

OB 

013 

Oil 

VT 

Vertical tabulation 

OC 

014 

012 

FF 

Form feed 

OD 

015 

013 

CR 

Carriage return 

OE 

016 

014 

SO 

Shift out 

OF 

017 

015 

SI 

Shift in 

10 

020 

016 

DLE 

Data link escape 

11 

021 

017 

DC1 

Device control 1 

12 

022 

018 

DC2 

Device control 2 

13 

023 

019 

DC3 

Device control 3 

14 

024 

020 

DC4 

Device control 4 

15 

025 

021 

NAK 

Negative acknowledge 

16 

026 

022 

SYN 

Synchronous idle 

17 

027 

023 

ETB 

End of transmission block 

18 

030 

024 

CAN 

Cancel 

19 

031 

025 

EM 

End of medium 

1A 

032 

026 

SUB 

Substitute 

IB 

033 

027 

ESC 

Escape 

1C 

034 

028 

FS 

File separator 

ID 

035 

029 

GS 

Group separator 

IE 

036 

030 

RS 

Record separator 

IF 

037 

031 

US 

Unit separator 

20 

040 

032 

SP 

Space 

21 

041 

033 

! 

Exclamation point 

22 

042 

034 

" 

Quotation marks (double quote) 

23 

043 

035 

# 

Number sign 

24 

044 

036 

$ 

Dollar sign 
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SORT 

/COLLATING-SEQUENCE 


Table SORT-1 (Cont.) DEC Multinational Collating Sequence 


HEX 

Code 

Octal 

Code 

Decimal 

Code 

Char or 
Abbrev. 

Description 

25 

045 

037 

% 

Percent sign 

26 

046 

038 

& 

Ampersand 

27 

047 

039 

' 

Apostrophe (single quote) 

28 

050 

040 

( 

Opening parenthesis 

29 

051 

041 

) 

Closing parenthesis 

2A 

052 

042 

• 

Asterisk 

2B 

053 

043 

+ 

Plus 

2C 

054 

044 

/ 

Comma 

2D 

055 

045 

- 

Hyphen or minus 

2E 

056 

046 


Period or decimal point 

2F 

057 

047 

/ 

Slash 

30 

060 

048 

0 

Zero 

31 

061 

049 

1 

One 

32 

062 

050 

2 

Two 

33 

063 

051 

3 

Three 

34 

064 

052 

4 

Four 

35 

065 

053 

5 

Five 

36 

066 

054 

6 

Six 

37 

067 

055 

7 

Seven 

38 

070 

056 

8 

Eight 

39 

071 

057 

9 

Nine 

3A 

072 

058 


Colon 

3B 

073 

059 

/ 

Semicolon 

3C 

074 

060 

< 

Less than 

3D 

075 

061 

= 

Equals 

3E 

076 

062 

> 

Greater than 

3F 

077 

063 

? 

Question mark 

40 

100 

064 

@ 

Commercial at 

61 

141 

097 

a 

Lowercase a 

41 

101 

065 

A 

Uppercase A 

E0 

340 

224 

a 

Lowercase a with grave accent 

CO 

300 

192 

A 

Uppercase A with grave accent 

El 

341 

225 

a 

Lowercase a with acute acent 

Cl 

301 

193 

A 

Uppercase A with acute accent 

E2 

342 

226 

a 

Lowercase a with circumflex 

C2 

302 

194 

A 

Uppercase A with circumflex 

E3 

343 

227 

a 

Lowercase a with tilde 
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SORT 

/COLLATING-SEQUENCE 


Table SORT- 

1 (Cont.) 

DEC Multinational Collating Sequence 

HEX 

Code 

Octal 

Code 

Decimal 

Code 

Char or 
Abbrev. 

Description 

C3 

303 

195 

A 

Uppercase A with tilde 

E4 

344 

228 

a 

Lowercase a with umlaut,(diaeresis) 

C4 

304 

196 

A 

Uppercase A with umlaut,(diaeresis) 

62 

142 

098 

b 

Lowercase b 

42 

102 

066 

B 

Uppercase B 

63 

143 

099 

c 

Lowercase c 

43 

103 

067 

C 

Uppercase C 

E7 

347 

231 

S 

Lowercase c with cedilla 

C7 

307 

199 

? 

Uppercase C with cedilla 

64 

144 

100 

d 

Lowercase d 

44 

104 

068 

D 

Uppercase D 

65 

145 

101 

e 

Lowercase e 

45 

105 

069 

E 

Uppercase E 

E8 

350 

232 

e 

Lowercase e with grave accent 

C8 

310 

200 

E 

Uppercase E with grave accent 

E9 

351 

233 

e 

Lowercase e with acute accent 

C9 

311 

201 

E 

Uppercase E with acute accent 

EA 

352 

234 

e 

Lowercase e with circumflex 

CA 

312 

202 

E 

Uppercase E with circumflex 

EB 

353 

235 

e 

Lowercase e with umlaut,(diaeresis) 

CB 

313 

203 

E 

Uppercase E with umlaut,(diaeresis) 

66 

146 

102 

f 

Lowercase f 

46 

106 

070 

F 

Uppercase F 

67 

147 

103 

g 

Lowercase g 

47 

107 

071 

G 

Uppercase G 

68 

150 

104 

h 

Lowercase h 

48 

110 

072 

H 

Uppercase H 

69 

151 

105 

i 

Lowercase i 

49 

111 

073 

1 

Uppercase 1 

EC 

354 

236 

i 

Lowercase i with grave accent 

CC 

314 

204 

i 

Uppercase 1 with grave accent 

ED 

355 

237 

\ 

Lowercase i with acute accent 

CD 

315 

205 

\ 

Uppercase 1 with acute accent 

EE 

356 

238 

i 

Lowercase i th circumflex 

CE 

316 

206 

i 

Uppercase 1 with circumflex 

EF 

357 

239 

i 

Lowercase i with umlaut,(diaeresis) 

CF 

317 

207 

T 

Uppercase 1 with umlaut,(diaeresis) 
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SORT 

/COLLATING-SEQUENCE 


Table SORT-1 (Cont.) DEC Multinational Collating Sequence 


HEX Octal Decimal Char or Description 

Code Code Code Abbrev. 


6A 

152 

106 

j 

4A 

112 

074 

J 

6B 

153 

107 

k 

4B 

113 

075 

K 

6C 

154 

108 

1 

4C 

114 

076 

L 

6D 

155 

109 

m 

4D 

115 

077 

M 

6E 

156 

110 

n 

4E 

116 

078 

N 

FI 

361 

241 

n 

D1 

321 

209 

N 

6F 

157 

111 

o 

4F 

117 

079 

0 

F2 

362 

242 

6 

D2 

322 

210 

6 

F3 

363 

243 

6 

D3 

323 

211 

6 

F4 

364 

244 

6 

D4 

324 

212 

0 

F5 

365 

245 

6 

D5 

325 

213 

6 

F6 

366 

246 

6 

D6 

326 

214 

6 

F7 

367 

247 

oe 

D7 

327 

215 

CE 

70 

160 

112 

P 

50 

120 

080 

P 

71 

161 

113 

q 

51 

121 

081 

Q 

72 

162 

114 

r 

52 

122 

082 

R 

73 

163 

115 

s 

53 

123 

083 

S 

DF 

337 

223 

3 

74 

164 

116 

t 

54 

124 

084 

T 


Lowercase j 
Uppercase J 
Lowercase k 
Uppercase K 
Lowercase I 
Uppercase L 
Lowercase m 
Uppercase M 
Lowercase n 
Uppercase N 
Lowercase n with tilde 
Uppercase N with tilde 
Lowercase o 
Uppercase O 

Lowercase o with grave acent 
Uppercase O with grave accent 
Lowercase o with acute accent 
Uppercase O with acute accent 
Lowercase o with circumflex 
Uppercase O with circumflex 
Lowercase o with tilde 
Uppercase O with tilde 
Lowercase o with umlaut,(diaeresis) 
Uppercase O with umlaut,(diaeresis) 
Lowercase oe ligature 
Uppercase OE ligature 
Lowercase p 
Uppercase P 
Lowercase q 
Uppercase Q 
Lowercase r 
Uppercase R 
Lowercase s 
Uppercase S 

German lowercase sharp s 
Lowercase t 
Uppercase T 
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SORT 

/COLLATING-SEQUENCE 


Table SORT—1 (Cont.) DEC Multinational Collating Sequence 


HEX 

Code 

Octal 

Code 

Decimal 

Code 

Char or 
Abbrev. 

Description 

75 

165 

117 

u 

Lowercase u 

55 

125 

085 

U 

Uppercase U 

F9 

371 

249 

u 

Lowercase u with grave accent 

D9 

331 

217 

0 

Uppercase U with grave accent 

FA 

372 

250 

u 

Lowercase u with acute accent 

DA 

332 

218 

U 

Uppercase U with acute accent 

FB 

373 

251 

u 

Lowercase u with circumflex 

DB 

333 

219 

0 

Uppercase U with circumflex 

FC 

374 

252 

u 

Lowercase u with umlaut,(diaeresis) 

DC 

334 

220 

0 

Uppercase U with umlaut,(diaeresis) 

76 

166 

118 

V 

Lowercase v 

56 

126 

086 

V 

Uppercase V 

77 

167 

119 

w 

Lowercase w 

57 

127 

087 

W 

Uppercase W 

78 

170 

120 

X 

Lowercase x 

58 

130 

088 

X 

Uppercase X 

79 

171 

121 

y 

Lowercase y 

59 

131 

089 

Y 

Uppercase Y 

FD 

375 

253 

y 

Lowercase y with umlaut,(diaeresis) 

DD 

335 

221 

Y 

Uppercase Y with umlaut,(diaeresis) 

7 A 

172 

122 

z 

Lowercase z 

5A 

132 

090 

Z 

Uppercase Z 

E6 

346 

230 

ae 

Lowercase ae diphthong 

C6 

306 

198 

/E 

Uppercase AE with diphthong 

F8 

370 

248 

o 

Lowercase o with slash 

D8 

330 

216 

0 

Uppercase 0 with slash 

E5 

345 

229 

a 

Lowercase a with ring 

C5 

305 

197 

A 

Uppercase A with ring 

5B 

133 

091 

[ 

Opening bracket 

5C 

134 

092 

\ 

Backslash 

5D 

135 

093 

] 

Closing bracket 

5E 

136 

094 


Circumflex 

5F 

137 

095 

— 

Underline (underscore) 

60 

140 

096 

N 

Grave accent 

7B 

173 

123 

{ 

Opening brace 

7C 

174 

124 

1 

Vertical line 

7D 

175 

125 

} 

Closing brace 
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SORT 

/COLLATING-SEQUENCE 


Table SORT-1 (Cont.) DEC Multinational Collating Sequence 


HEX Octal Decimal Char or Description 

Code Code Code Abbrev. 


7E 

176 

126 


7F 

177 

127 

DEL 

84 

204 

132 

IND 

85 

205 

133 

NEL 

86 

206 

134 

SSA 

87 

207 

135 

ESA 

88 

210 

136 

HTS 

89 

211 

137 

HTJ 

8A 

212 

138 

VTS 

8B 

213 

139 

PLD 

8C 

214 

140 

PLU 

8D 

215 

141 

Rl 

8E 

216 

142 

SS2 

8F 

217 

143 

SS3 

90 

220 

144 

DCS 

91 

221 

145 

PU1 

92 

222 

146 

PU2 

93 

223 

147 

STS 

94 

224 

148 

CCH 

95 

225 

149 

MW 

96 

226 

150 

SPA 

97 

227 

151 

EPA 

9B 

233 

155 

CSI 

9C 

234 

156 

ST 

9D 

235 

157 

OSC 

9E 

236 

158 

PM 

9F 

237 

159 

APC 

A1 

241 

161 

i 

A2 

242 

162 

C 

A3 

243 

163 

£ 

A5 

245 

165 

¥ 

A7 

247 

167 

§ 

A8 

250 

168 

B 

A9 

251 

169 

© 

AA 

252 

170 

£ 

AB 

253 

171 

« 

BO 

260 

176 

o 


Tilde 

Delete, rubout 

Index 

Next line 

Start of selected area 

End of started area 

Horizontal tab set 

Horizontal tab set with justification 

Vertical tab set 

Partial line down 

Partial line up 

Reverse index 

Single shift 2 

Single shift 3 

Device control string 

Private use 1 

Private use 2 

Set transmit state 

Cancel character 

Message waiting 

Start of protected area 

End of protected area 

Control sequence introducer 

String terminator 

Operating system command 

Privacy message 

Application 

Inverted exclamation mark 

Cent sign 

Pound sign 

Yen sign 

Section sign 

General currency sign 

Copyright sign 

Feminine ordinal indicator 

Angle quotation mark left 

Degree sign 
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SORT 

/COLLATING-SEQUENCE 


Table SORT-1 (Cont.) DEC Multinational Collating Sequence 


HEX 

Code 

Octal 

Code 

Decimal 

Code 

Char or 
Abbrev. 

Description 

B1 

261 

177 

± 

Plus/minus sign 

B2 

262 

178 

2 

Superscript 2 

B3 

263 

179 

3 

Superscript 3 

B5 

265 

181 


Micro sign 

B6 

266 

182 

H 

Paragraph sign, pilcrow 

B7 

267 

183 

• 

Middle dot 

B9 

271 

185 

1 

Superscript 1 

BA 

272 

186 

£ 

Masculine ordinal indicator 

BB 

273 

187 

» 

Angle quotation mark right 

BC 

274 

188 

!4 

Fraction one quarter 

BD 

275 

189 

y 2 

Fraction one half 

BF 

277 

191 

6 

Inverted question mark 

Table SORT-2 contains the ASCII collating sequence. 

Table SORT- 

-2 ASCII Collating Sequence 

ASCII 


Hex 

Octal 

Decimal 

Character 

Code 

Code 

Code 

NUL 


00 

000 

0 

SOH 


01 

001 

1 

STX 


02 

002 

2 

ETX 


03 

003 

3 

EOT 


04 

004 

4 

ENQ 


05 

005 

5 

ACK 


06 

006 

6 

BEL 


07 

007 

7 

BS 


08 

010 

8 

HT 


09 

Oil 

9 

LF 


OA 

012 

10 

VT 


OB 

013 

11 

FF 


OC 

014 

12 

CR 


OD 

015 

13 

SO 


OE 

016 

14 

SI 


OF 

017 

15 

DLE 


10 

020 

16 

DC1 


11 

021 

17 
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SORT 

/COLLATING-SEQUENCE 


Table SORT-2 (Cont.) ASCII Collating Sequence 


ASCII 

Character 

Hex 

Code 

Octal 

Code 

Decimal 

Code 

DC2 

12 

022 

18 

DC3 

13 

023 

19 

DC4 

14 

024 

20 

NAK 

15 

025 

21 

SYN 

16 

026 

22 

ETB 

17 

027 

23 

CAN 

18 

030 

24 

EM 

19 

031 

25 

SUB 

1A 

032 

26 

ESC 

IB 

033 

27 

FS 

1C 

034 

28 

GS 

ID 

035 

29 

RS 

IE 

036 

30 

US 

IF 

037 

31 

SP 

20 

040 

32 

! 

21 

041 

33 

n 

22 

042 

34 

# 

23 

043 

35 

$ 

24 

044 

36 

% 

25 

045 

37 

& 

26 

046 

38 

/ 

27 

047 

39 

< 

28 

050 

40 

> 

29 

051 

41 

• 

2A 

052 

42 

+ 

2B 

053 

43 

, 

2C 

054 

44 

— 

2D 

055 

45 

. 

2E 

056 

46 

/ 

2F 

057 

47 

0 

30 

060 

48 

1 

31 

061 

49 

2 

32 

062 

50 

3 

33 

063 

51 

4 

34 

064 

52 

5 

35 

065 

53 

6 

36 

066 

54 
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SORT 

/COLLATING-SEQUENCE 


Table SORT—2 (Cont.) ASCII Collating Sequence 


ASCII 

Character 

Hex 

Code 

Octal 

Code 

Decimal 

Code 

7 

37 

067 

55 

8 

38 

070 

56 

9 

39 

071 

57 


3A 

072 

58 

/ 

3B 

073 

59 

< 

3C 

074 

60 

= 

3D 

075 

61 

> 

3E 

076 

62 

? 

3F 

077 

63 

@ 

40 

100 

64 

A 

41 

101 

65 

B 

42 

102 

66 

C 

43 

103 

67 

D 

44 

104 

68 

E 

45 

105 

69 

F 

46 

106 

70 

G 

47 

107 

71 

H 

48 

110 

72 

1 

49 

111 

73 

J 

4A 

112 

74 

K 

4B 

113 

75 

L 

4C 

114 

76 

M 

4D 

115 

77 

N 

4E 

116 

78 

0 

4F 

117 

79 

P 

50 

120 

80 

Q 

51 

121 

81 

R 

52 

122 

82 

S 

53 

123 

83 

T 

54 

124 

84 

U 

55 

125 

85 

V 

56 

126 

86 

w 

57 

127 

87 

X 

58 

130 

88 

Y 

59 

131 

89 

z 

5A 

132 

90 

[ 

5B 

133 

91 
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/COLLATING-SEQUENCE 


Table SORT-2 (Cont.) ASCII Collating Sequence 


ASCII 

Character 

Hex 

Code 

Octal 

Code 

Decimal 

Code 

\ 

5C 

134 

92 

i 

5D 

135 

93 

* 

5E 

136 

94 

- 

5F 

137 

95 

V 

60 

140 

96 

a 

61 

141 

97 

b 

62 

142 

98 

c 

63 

143 

99 

d 

64 

144 

100 

e 

65 

145 

101 

f 

66 

146 

102 

g 

67 

147 

103 

h 

68 

150 

104 

i 

69 

151 

105 

j 

6A 

152 

106 

k 

6B 

153 

107 

1 

6C 

154 

108 

m 

6D 

155 

109 

n 

6E 

156 

110 

o 

6F 

157 

111 

P 

70 

160 

112 

q 

71 

161 

113 

r 

72 

162 

1 14 

s 

73 

163 

115 

t 

74 

164 

1 16 

u 

75 

165 

117 

V 

76 

166 

1 18 

w 

77 

167 

1 19 

X 

78 

170 

120 

y 

79 

171 

121 

z 

7 A 

172 

122 

{ 

7B 

173 

123 

1 

7C 

174 

124 

> 

7D 

175 

125 


7E 

176 

126 

DEL 

7F 

177 

127 
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SORT 

/COLLATING-SEQUENCE 


EXAMPLE 

$ SORT/COLLATING_SEQUENCE=MULTINATIONAL - 
_$ NAMES.DAT,NOM.DAT LIST.LIS 

This SORT command arranges the input files NAMES.DAT and NOM.DAT 
according to the MULTINATIONAL collating sequence to create the output 
file LIST.LIS. 
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SORT 

/DUPLICATES 


/DUPLICATES 

Eliminates all but one of multiple records with duplicate keys. By 



default, SORT retains multiple records with duplicate keys. 

FORMAT 

/[NO]DUPLICATES 

DESCRIPTION 

By default, SORT/MERGE retains records with equal keys. The 
/NODUPLICATES qualifier eliminates all but one of records with equal 
keys. The retained record is unpredictable. If you want to specify which 
duplicate record to keep, invoke SORT at the program level and specify an 
equal-key routine. See VAX/VMS Utility Routines Reference Manual for more 
detail. 

The /STABLE and the /NODUPLICATES qualifiers are mutually exclusive. 


EXAMPLE 

$ SORT/KEY=(POSITION:3.SIZE:5,DECIMAL)/NODUPLICATES - 
_$ ACCT1,ACCT2 ACCT.LIS 

This SORT command arranges the two input files according to the key 
supplied and eliminates all but one of multiple records with equal keys. 
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SORT 

/KEY 


/KEY 


FORMAT 

qualifier values 


Describes key field(s), including the position, size, sorting order, and 
data type. By default, SORT reorders a file by sorting entire records 
with character data in ascending order. Any other type of key field 
must be specified. When specifying multiple keys, use a separate 
/KEY qualifier for each key. 


/KEY=(field [,...]) 


POSITION:n 

Specifies the position of the first byte in the key field. A value of 1 to 32,767 
may be specified. The first byte in a record is considered position 1. Both 
the position and the size of the key field must be specified. If a decimal sign 
is stored in a separate byte in the key field, that byte is counted when you 
determine position. 

SIZE:n 

Specifies the length of the key field. Both the position and size of the key 
field must be specified. The total composite size of all keys and the original 
input record length must be less than 32,767 bytes. If the decimal sign is 
stored in a separate byte in the key field, that byte is not counted toward the 
size of the data. 

The data type of the key determines what values are acceptable when 
specifying size: 

• 1 to 32,767 characters for character data 

• 1, 2, 4, 8, or 16 bytes for binary data 

• 1 to 31 digits for decimal data 

• No value is necessary for floating point data 


ASCENDING 

Orders the sorting operation in ascending alphabetical or numerical order. 
ASCENDING is the default order. 

DESCENDING 

Orders the sorting operation in descending alphabetical or numerical order. 

CHARACTER 

Specifies character data in the key field. CHARACTER is the default data 
type. 

BINARY 

Specifies binary data in the key field. 
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SIGNED 

Specifies signed binary or decimal data in key field. SIGNED is the default 
for binary and decimal data. 

UNSIGNED 

Specifies unsigned binary or decimal data in the key field. 

F_ FLOATING 

Specifies F_FLOATING format data in the key field. 

D—FLOATING 

Specifies D_FLOATING format data in the key field. 

G-FLOATING 

Specifies G_FLOATING format data in the key field. 

H—FLOATING 

Specifies H__FLOATING format data in the key field. 

DECIMAL 

Specifies decimal data in the key field. 

TRAI LING_SIGN 

Specifies trailing sign decimal data in the key field. TRAILING—SIGN is the 
default for decimal data. 

LEADING-SIGN 

Specifies leading sign decimal data in the key field. 

OVERPUNCHED-SIGN 

Specifies overpunched decimal data in the key field. OVERPUNCHED-SIGN 
is the default for decimal data. 

SEPARATE-SIGN 

Specifies separate sign decimal data in the key field. 

ZONED 

Specifies zoned decimal data in the key field. 

PACKED-DECIMAL 

Specifies packed decimal data in the key field. 

NUMBER.n 

Specifies the order of priority of each key if you do not list multiple keys in 
the order of their priority. A value of 1 to 255 may be specified. 


DESCRIPTION The /KEY qualifier specifies all the necessary information about a key field. If 

the file(s) is to be sorted using entire records with character data in ascending 
order, specifying the key information is unnecessary. 
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When a key field must be described, you must specify both the position and 
the size of the key. Also, if the sorting or merging operation is to be done 
in descending alphabetic or numeric order, specify DESCENDING in the key 
description. 

If the data in the key field(s) is not character data, you must specify the data 
type. Data types recognized by the Sort Utility are as follows: 

CHARACTER 
BINARY, [SIGNED] 

BINARY, UNSIGNED 
F_FLOATING 
D_FLOATING 
G_FLOATING 
H_FLOATING 
ZONED 

DECIMAL [,SIGNED, TRAILING—SIGN, OVERPUNCHED-SIGN] 
DECIMAL, LEADING-SIGN, SEPARATE-SIGN [SIGNED] 

DECIMAL, LEADING-SIGN, [OVERPUNCHED-SIGN, SIGNED] 
DECIMAL, [TRAILING SIGN], SEPARATE-SIGN, [SIGNED] 

DECIMAL, UNSIGNED 
PACKED-DECIMAL 

The items in brackets are defaults and need not be specified. 

Multiple Keys 

You can specify up to 255 key fields in a sorting operation. If you do specify 
multiple keys, decide which is primary, which is secondary, and so on, and 
then in the command string, list them in the order of their priority. 

By default, SORT assigns 1 to the first key specified in the command line, 2 
to the second key, and so on. If you do not list the keys in the order of their 
priority, specify the order of each with the parameter NUMBER:n. 

For each sort key, you must use a separate /KEY qualifier. If SORT finds 
/KEY parameters repeated after a single /KEY qualifier, it does not treat these 
as specifications for multiple keys; instead, the duplicate parameters override 
previously specified parameters. 


EXAMPLE 


$ SORT/KEY=(POS:16,SIZ:3)/KEY=(P0S:1,SIZ:11) - 
_$ /KEY=(POS:40,SIZ:2,DESC) YRENDAVG.DAT YRAVGSRT.LIS 

This SORT command identifies three key fields. The input file, YRENDAVG, 
will first be sorted by the key beginning in position 16, then by the key 
beginning in position 1, and finally by the key beginning in position 40. The 
third key used will sort in descending order. 
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/PROCESS 

Defines the internal sorting process. The /PROCESS qualifier allows 



you to choose one of four processes: record, tag, address, or index. 
By default, SORT uses a record sorting process. Use only with the 
Sort Utility. 

FORMAT 

/PROCESS =type 

qualifier values 

RECORD 

Keeps records intact while sorting and produces an output file consisting of 
complete records. Record is the default sorting process. 

TAG 

Sorts only the keys and then rereads the input file to produce an output file 
consisting of complete records. 

ADDRESS 

Sorts only the keys and produces an output file that is an index of record 
addresses in binary format. The index must be submitted to a program for 
further processing. 

INDEX 

Sorts only the keys and produces an output file that is an index of keys and of 
record addresses in binary form. The index must be submitted to a program 
for further processing. 

DESCRIPTION 

You can choose one of four processing methods for the sorting of your 
data: record, tag, address, or index sort. Record sort is the default. The four 
processes result in varied output file formats; they also differ in input and 
output device requirements and processing methods. 

When selecting a sort process, consider: 

1 How you will use the output file. 

• Because record and tag sort generate files containing entire sorted 
records, these reordered files are ready to be used. 

• Both address and index sorted output files can be processed by a 
program written in native-mode BASIC, MACRO, or BLISS. 

• Address sort creates a list of pointers to the records in the input file. 
This list consists of binary record's file addresses (RFAs), plus a file 
number when sorting multiple input files. A program accesses the 
records by use of the pointers. 

• Index sort creates an output file containing both RFAs and key fields, 
plus a file number when sorting multiple files. The format of these key 
fields is the same as in the input files. If the program needs key field 
content for a decision during future processing, select index sort rather 
than address sort. 
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If you need to reorder records from one file in several ways for 
different purposes, store several output files from address or index 
sort and use the files to access the records in the main file in the sorted 
order you want. 

2 The temporary storage space available for the sort. 

• Tag sort uses less temporary storage space than record sort. Because 
record sort keeps the record intact during the sort, it uses much more 
work space when the files are large. 

• Address and index sort use little temporary storage space. 

3 The type of input and output device used. 

• Record sort is the only process that can accept input from cards, 
magnetic tape, and disk. 

• Output from tag and record sorts can go to any output device; output 
from address and index sort must go to a device that accepts binary 
data. 

4 Differences in speed. 

• If you plan to retrieve the sorted records at some point in the operation, 
record sort will usually be the fastest process. 

• Because tag sort moves only keys instead of complete records, it can 
be faster than record sort when record size is very large and key size is 
small. Tag sort can also be faster for extremely large files and devices 
with fast seek times. In most cases, however, the time that tag sort 
takes to reaccess the input file to create the output file makes it slower 
than record sort. 

• Address and index sort are the fastest processes. 


EXAMPLE 

$ SORT/KEY=(POS:40,SIZ:2,DESC)/PR0CESS=TAG YRENDAVG.DAT- 
_$ DESCYRAVG.LIS 

This SORT operation uses a tag sorting process to create the output file, 
DESCYRAVG.LIS. 
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/SPECIFICATION 

Identifies a SORT or MERGE specification file. 


FORMAT /SPECIFICATIO N=file-spec 

qualifier value file-spec 

Specifies the SORT/MERGE specification file. The default file type is SRT. 


DESCRIPTION The /SPECIFICATION qualifier identifies the specification file to be used in a 
SORT or MERGE operation. A specification file allows you to 

• Change the format and length of the records in the output file 

• Conditionally alter record order and data fields 

• Omit specified records from the process 

• Include specified records in the process 

• Change the way in which characters are ordered 

• Reassign work files 

• Define commonly used SORT or MERGE operations 

See the Description Section and the Specification File Qualifiers Section for 
more information about specification files. 


EXAMPLE 

$ SORT/SPECIFICATION=ACCTS.SRT SALES1.DAT.SALES2.DAT MAILING.LIS 

This SORT command arranges the input files according to the instructions 
detailed in the specification file, ACCTS.SRT. 
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/STABLE 

Directs records with equal keys to the output file in their input file 
order. The default condition is /NOSTABLE. 

FORMAT 

/[NO]STABLE 

DESCRIPTION 

When the input file(s) contains records with equal keys, those records are 
grouped in an unpredictable order. Specifying the /STABLE qualifier arranges 
records with equal keys in the order of the input files on output. If you use 
this qualifier when sorting multiple input files, on output, records with equal 
keys in the first file will precede those from the second file and so on. 

The /STABLE and /NODUPLICATES qualifiers are mutually exclusive. 


EXAMPLE 

$ S0RT/KEY=(P0S:1.SI:5,DECIMAL)/STABLE PRICESA.DAT.PRICESB.DAT - 
_$ PRICESC.DAT SUMMARY.LIS 

In this sort operation, records with equal keys from PRICESA.DAT will be 
listed first, followed by those from PRICESB.DAT, followed by those from 
PRICESC.DAT. 


SORT-32 








SORT 

/STATISTICS 


/STATISTICS 

Displays a statistical summary that may be used for optimization. 


FORMAT /STATISTICS 


DESCRIPTION When the /STATISTICS qualifier is used, SORT/MERGE displays statistics 

in SYS$OUTPUT. You can use these statistics to judge the efficiency of 
the ordering operation and to determine adjustments that will improve its 
performance. To save these statistics in a file, specify the following command: 

$ DEFINE/USER SYS$ERROR output-file 

The following statistical display results when you use the /STATISTICS 
qualifier. 


VAX-11 Sort/Merge 


Records read: nnn 
Records sorted: nnn 
Records output: nnn 
Working set extent: nnn 
Virtual memory: nnn 
Direct I/O: nnn 
Buffered I/O: nnn 
Page faults: nnn 


Elapsed time: nn:nn:nn.nn 


Statistics 

Input record length: nnn 
Internal length: nnn 
Output record length: nnn 
Sort tree size: nnn 
Number of initial runs: nnn 
Maximum merge order: nnn 
Number of merge passes: nnn 
Work file allocation: nnn 


Elapsed CPU: nn:nn:nn.nn 


Records read is the number of records read by SORT or MERGE. 

Records sorted is the number of records sorted. This number could be less 
than the number of records read if a specification file is used to select only 
certain records for the sort or merge operation. 

Records output is the number of records written to the output file. This 
number could be less than the number of records sorted if /NODUPLICATES 
was selected, or if I/O errors occurred when the output records were being 
written. 


Working set extent shows the number of pages in the process working 
set extent. This value is used as an upper limit on the size of the sort data 
structure. Adjusting this value is one way to improve the efficiency of a sort 
operation. 

Virtual memory is the number of pages of virtual memory added to the 
SORT image to hold the data. 

The total of the direct I/O and buffered I/O is the number of I/O 
movements needed to read and write data. The lower these values are, 
the more efficient the ordering operation. 

The number of page faults also indicates how well the data fits into memory. 
The higher the number of page faults is, the less efficient the ordering 
operation. 

Elapsed time is the total wall clock time used by the sort or merge operation, 
in hours, minutes, seconds, and hundredths of seconds. 

The input record length value is obtained from RMS unless the user supplies 
it. 
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Internal length is the size in bytes of an internal format node. This includes 
any keys, data, a word to store the length, RFAs, and converted keys. 

Output record length is the length of the output record. The length is 
computed from the input record length, the sort process, and the record 
reformatting requested. 

Sort tree size is the number of records that fit in sort's internal sort data 
structure. 

Number of initial runs is one indication of how well the data fits into 
memory. 

The maximum merge order is the maximum number of sorted strings that 
are merged at one time. 

The number of merge passes is the number of times SORT merges strings 
until one sorted output string is produced. The number of initial runs and 
the number of merge passes indicate how well the data fits in memory. The 
higher these numbers are, the further the working set size is from containing 
the data, and the longer the sort takes. 

Work file allocation is the number of blocks used for the work files. When 
more than one merge pass is needed, this size is approximately twice the size 
of the input file allocation. 

Elapsed CPU is the CPU time used by the ordering operation; it does not 
include time spent waiting for I/O operations to complete or time spent 
waiting while another process executes. 


EXAMPLE 


$ SORT /STATISTICS PRICE1.DAT.PRICE2.DAT PRICE.LIS 

This SORT command results in the following statistical display: 


VAX-11 Sort/Merge Statistics 


Records read: 

793 

Input record length: 

80 

Records sorted: 

793 

Internal length: 

80 

Records output: 

793 

Output record length: 

80 

Working set extent: 

100 

Sort tree size: 

412 

Virtual memory: 

433 

Number of initial runs: 

2 

Direct I/O: 

22 

Maximum merge order: 

2 

Buffered I/O: 

9 

Number of merge passes: 

1 

Page faults: 

3418 

Work file allocation: 

114 

Elapsed time: 00:00: 

05.98 

Elapsed CPU: 00:00: 

03.63 


In the sample statistics display, the sort data structure size is limited by the 
small working set extent. Doubling the working set extent will almost double 
the sort data structure size. Then all the records will fit in memory, and no 
work files will be used. 
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/WORK_FILES 

Used for optimization 


FORMAT 

/WORK_FILES=n 

qualifier value 

n 

Specifies the number of work files requested; 0 to 10 files may be specified. 

DESCRIPTION 

SORT does not create work files until it needs them. If SORT needs work 
files, it creates two (SORTWORKO, SORTWORK1) by default that are placed 
in SYS$SCRATCH. Usually, there is no advantage to requesting more than 
one work file. However, if the available disks are too small or too full for 
SORT work files, you can increase the number of work files by any number 
from 1 through 10 to make each work file smaller. 


EXAMPLE 

$ ASSIGN DRA5: SORTWORKO 
$ ASSIGN DBO: S0RTW0RK1 
$ ASSIGN DB1: S0RTW0RK2 
$ SORT/KEY=(POS:1,SI:80)/W0RK_FILES=3 - 
_$ STATS1.STATS2.STATS3,STATS4 SUMMARY.LIS 

Since the input files in this sort operation are large files, specifying three work 
files improves the efficiency of the sort operation. 
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INPUT FILE 
QUALIFIER 


This section describes the qualifier to the input file. This qualifier should be 
specified immediately after the input file specification. 
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/FORMAT 

Defines input file characteristics; allows you to specify or override 
record or file size. 

FORMAT 

input file-spec /FORMAT=(type:n,[...]) 

qualifier values 

RECORD^.SIZE: n 

Specifies the file's longest record length (LRL) in bytes. 

The maximum longest record length that can be specified depends on the file 
organization: 

Sequential files 32,767 

Relative files 16,383 

Indexed-sequential files 16,362 

These totals include control bytes for variable records with fixed-length 
control (VFC) format. 

FILE_SIZE:n 

Specifies input file size in blocks. The maximum file size accepted is 
4,294,967,295 blocks. 

DESCRIPTION 

SORT obtains the LRL and file size from RMS. If you know that the LRL that 
RMS has defined for the input file(s) is incorrect, you can override this value 
by specifying the record size with RECORD-SIZE. For multiple input files, 
LRL is the length of the longest record in all files. 

If you do not know the LRL value for a file, use the ANALYZE/RMS—FILE 
command. The LRL value appears in the file attributes section in the 
statistical report generated for the file that you specify. 

SORT uses input file size information to determine the amount of memory 
needed, as well as the size of the work files for the sort operation. If the file 
size is unknown, (for example you are sorting file(s) not residing on disk or 
standard ANSI magnetic tape) SORT assumes a fairly large file size. 

If this default is too large, SORT will overestimate its memory and work 
file requirements; the sort operation will be more efficient if you specify a 
smaller input file size. If the default is too small, SORT will underestimate its 
memory requirements; therefore, you should specify a larger input file size, 
provided the sort data structure size is not limited by the working set extent. 


EXAMPLE 

$ SORT/KE=(POS:40,SIZ:2,DESC) - 

_$ YRENDAVG.DAT/FORMAT=(RECORD_SIZE:41,FILE_SIZE:3) DESCYRAVG.LIS 

Because the input file, YRENDAVG.DAT, is not on disk or ANSI magnetic 
tape, file organization is described by the /FORMAT qualifier. 
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OUTPUT FILE 
QUALIFIERS 


This section describes the qualifiers to the output file. These qualifiers should 
be specified immediately after the output file specification. 
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/ALLOCATION 

Used for optimization. 


FORMAT 

output file-spec /ALLOCATIONS 

qualifier value 

n 

Specifies the number of blocks to be allocated. A value of 1 to 4,294,967,295 
is allowed. 

DESCRIPTION 

SORT/MERGE preallocates space for the output file based on total input file 
allocation, thereby avoiding the overhead of extending the file every time 
another few blocks are written to it. 

If you know, however, that the output file allocation will differ substantially 
from the total input file allocation (because you are reformatting data or 
omitting records) you can specify the number of blocks to be preallocated for 
the output file. 

The /ALLOCATION qualifier is required if the /CONTIGUOUS qualifier is 
used. 


EXAMPLE 

$ SORT/KEY=(POS:1,SIZ:80) STATS.DAT - 
_$ SUMMARY.LIS/ALLOCATION=1000/CONTIGUOUS 

This SORT command allocates 1000 contiguous blocks for the output file, 
SUMMARY.LIS. 
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/BUCKET- 

SIZE 


Used for optimization. 

FORMAT 

output file-spec /BUCKET_SIZE=n 

qualifier value 

n 

Specifies the bucket size. A value of 1 to 32 is allowed. 

DESCRIPTION 

Use the /BUCKET_SIZE qualifier with relative and indexed-sequential output 
disk files to specify RMS bucket size (the number of 512-byte blocks per 
bucket). If the output file organization is the same as for the input file(s), 
the default value is the same as the first input file bucket size. If output file 
organization is different, the default value is 1. The maximum number of 
blocks per bucket is 32. See the VAX Record Management Services Reference 
Manual for more information. 

EXAMPLE 


$ SORT/KEY=(POS:l.SI:80) STATS1.DAT.STATS2.DAT - 
_$ SUMMARY.LIS/BUCKET_SIZE=16/RELATIVE 

This SORT command results in the output file SUMMARY.LIS that has a 
bucket size of 16 with relative organization. 
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/CONTIGUOUS 

Used for optimization 


FORMAT 

output file-spec /CONTIGUOUS 

DESCRIPTION 

By default, SORT/MERGE does not allocate contiguous disk blocks for 
the ouput file. You can request, however, that the output file be stored in 
contiguous disk blocks by specifying the /CONTIGUOUS qualifier, thereby 
decreasing access time. If you use the /CONTIGUOUS qualifier, you must 
also specify the /ALLOCATION qualifier because if the preallocated space is 
too small, RMS may be unable to extend the file contiguously. 


EXAMPLE 

$ S0RT/KEY=(P0S:1,SIZ:80) STATS.DAT - 
_$ SUMMARY.LIS/ALL0CATI0N=1000/C0NTIGU0US 

This SORT command allocates 1000 contiguous blocks for the output file, 
SUMMARY.LIS. 
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/FORMAT 

Specifies the output file record format if it differs from the input file 
format. 

FORMAT 

output file-spec /FORMAT=(type:n ...) 

qualifier values 

FIXED.n 

Specifies fixed-length records in the output file. 

VARIABLE:n 

Specifies variable-length records in the output file. 

CONTROLLED:/! 

Specifies variable with fixed-length control (VFC) records in the output file. 

n 

Optionally indicates the maximum record size (in bytes) of the output records. 
The maximum record size allowed depends on the file organization. 

Sequential files 32,767 

Relative files 16,383 

Indexed-sequential files 16,362 

These totals include control bytes. If you do not specify the maximum record 
size, the default is a length large enough to hold the longest output record. 

SIZE:n 

Specifies the size, in bytes, of the fixed portion of VFC(CONTROLLED) 
records, up to a maximum of 255 bytes. If you do not specify SIZE, the 
default is the size of the fixed portion of the first input file. If you specify this 
size as 0, RMS defaults the value to 2 bytes. 

BLOCK—SIZE:n 

Specifies the output file's block size, in bytes, if you have directed the file 
to magnetic tape. You can also accept the default. If the input file is a 
tape file, the block size of the output file defaults to that of the input file. 
Otherwise, the output file block size defaults to the size used when the tape 
was mounted. 

Acceptable values for block size (n) range from 20 to 65,532. To ensure 
correct data interchange with other DIGITAL systems, however, specify 
a block size of not more than 512 bytes. For compatibility with most 
non-DIGITAL systems, the block size should not exceed 2048 bytes. 
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DESCRIPTION If the sort operation is a record or tag sort, the default output record format 

is the same as the first input file record format. If the sort operation is an 
address or index sort, the default output record format is fixed record format. 
If the input files have different record formats, SORT provides an output 
record size that is large enough to contain the largest record in the input files. 

In specifying the output record format, you can optionally indicate the 
maximum record size, in bytes, of the output records. You can specify 
fixed-length records, variable-length records, or variable with fixed-length 
control records. 


EXAMPLE 


$ SORT/KEY=(POS:1,SI:80) STATS.DAT SUMMARY.LIS/FORMAT=FIXED:80 

The input file, STATS.DAT, consists of variable-length records that are 
80 bytes in length. The /FORMAT qualifier specifies that the output file, 
SUMMARY.LIS, consists of fixed-length records. 
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/INDEXED—SEQUENTIAL 

Defines file organization. 


FORMAT output file-spec /I NDEXED_SEQUENTIAL 


DESCRIPTION If the organization of the output file is to be different from that of the 
input file(s), then you must specify the new organization. Use the 
/INDEXED—SEQUENTIAL qualifier to define indexed sequential organization 
for the output file. Additionally, the output file must exist and be empty, and 
you must use the /OVERLAY qualifier. 


EXAMPLE 

$ CREATE/FDL=NEW.FDL AVERAGE.DAT 
$ SORT/KEY=(POS:1,SI:80) DATA.DAT,STATS.DAT - 
_$ AVERAGE.DAT/INDEXED_SEQUENTIAL/OVERLAY 

The CREATE/FDL command creates an empty file, AVERAGE.DAT. The 
SORT command specifies that the output file have an indexed-sequential 
organization and be written to the empty file, AVERAGE.DAT. 
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/OVERLAY 

Specifies that the output file is to be overlaid on, or written to, an 
existing empty file. 


FORMAT output file-spec /OVERLAY 


DESCRIPTION If you specify indexed-sequential organization, the output file must already 
exist and must be empty. You must specify that the empty file is to be 
overlaid with the sorted records by using the /OVERLAY qualifier. 

If the input file organization is sequential or relative and if you create an 
empty file for the sorted records using an RMS Utility program, use the 
/OVERLAY qualifier to specify that the output file is to be overlaid. 

You can use the Create/FDL Utility to create an empty data file; use the 
/OVERLAY qualifier to specify that SORT is to write output to that file. Any 
attributes that you specify when creating the empty file will then become 
attributes of the SORT output file. See the VAX Record Management Services 
Reference Manual for more information. You can also refer to this manual if 
you want to use the Convert Utility to produce an indexed-sequential file on 
output. 


EXAMPLE 

$ CREATE/FDL=NEW.FDL AVERAGE.DAT 

$ SORT/KEY=(POS:1,SI:80) STATS.DAT AVERAGE.DAT/OVERLAY 

The FDL file, NEW.FDL, specifies special attributes for the file, 
AVERAGE.DAT. When SORT writes output to that file, the resulting SORT 
output file has the attributes specified by the FDL file. 
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/RELATIVE 

Defines output file organization as relative. 


FORMAT 

output file-spec /RELATIVE 

DESCRIPTION 

If the organization of the output file is to be different from that of the input 
file(s), then you must specify the new organization. If you do not specify 
file organization, the default for record and tag sorts is the organization of 
the first input file. You must use the /RELATIVE qualifier to specify relative 
output file organization. 


EXAMPLE 

$ S0RT/KEY=(POS:1,SI:80) STATS.DAT SUMMARY.LIS/RELATIVE 

Because the input file, STATS.DAT is not a relative file and the output file, 
SUMMARY.LIS, will be, /RELATIVE qualifies the output file specification. 
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/SEQUENTIAL 

Defines output file organization as sequential 


FORMAT 

output file-spec /SEQUENTIAL 

DESCRIPTION 

If the organization of the output file is to be different from that of the input 
file(s), you must specify the new organization. If you do not specify file 
organization, the default for record and tag sorts is the organization of the 
first input file. If you do not specify file organization, the default for address 
and index sorts is sequential organization. 

Use the /SEQUENTIAL qualifier when the default is not sequential file 
organization and you want an output file with sequential file format. 


EXAMPLE 

$ SORT/KEY=(POS:1,SI:80) STATS.DAT SUMMARY.LIS/SEQUENTIAL 

Because the input file STATS.DAT is not a sequential file and the output file 
SUMMARY.LIS will be, /SEQUENTIAL qualifies the output file specification. 
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SPECIFICA- This section describes the qualifiers you may use in a specification file. 

TION FILE 
QUALIFIERS 
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/CDD_PATH_NAME 



Allows use of the Common Data Dictionary record definitions. 

FORMAT 

/CDD_PATH_N AM E= "cdd-path-name " 

qualifier values 

"cdd-path-name " 

Specifies the CDD record definition. 

DESCRIPTION 

You may use the /CDD_PATH_NAME qualifier only if your system has 

VAX Common Data Dictionary (CDD) installed. The /CDD__PATH_NAME 
qualifier identifies CDD-defined fields and attributes for SORT. The 
"cdd-path-name" specifies a record definition within the CDD. Identifying 
these fields with this qualifier is the same as if they were specified with 
the /FIELD qualifier. /CDD_PATH__NAME can be used in place of or in 
conjunction with /FIELD statements. Once the fields have been identified, 
they may then be used in later specification file clauses, such as /KEY, 
/CONDITION, /INCLUDE, or /OMIT. 

EXAMPLE 


/CDD_PATH_NAME="customer" 

This /CDD_PATFL_NAME qualifier identifies the customer record, which 
was previously identified in the CDD. 
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/CHECK-SEQUENCE 


Specifies whether or not the Merge Utility checks the sequence of 
records. 


FORMAT 

/[NO]CHECK_SEQUENCE 

DESCRIPTION 

By default, MERGE checks the sequence of records in the input file(s). If 
you want to override that default, specify /NOCHECK__SEQUENCE in your 
specification file text. 

EXAMPLE 


/NOCHECK.SEQUENCE 

This /NOCHECK_SEQUENCE clause overrides MERGE's default behavior. 




SORT—50 









SORT 

/COLLATING-SEQUENCE 


/COLLATING-SEQUENCE 

Specifies one of three predefined collating sequences or a 
user-defined sequence for character key field(s). Allows you to 
modify any of the predefined collating sequences or any previously 
defined user-defined sequences. 


FORMAT /COLLATING-SEQUENCE = 

(SEQ UENCE=sequence _ type 
[,MODIFICA TION=(character operator character)] 
[,!GNORE=character or character-range,...] 
[.FOLD] 

[,[NO]TIE—BREAK]) 


qualifier values SEQUENCE=sequence—type 

ASCII 

Specifies ASCII collating sequence, which is the default sequence. 

EBCDIC 

Arranges characters according to EBCDIC sequence. The characters remain in 
ASCII representation; only the order is changed. 

MULTINATIONAL 

Arranges characters according to MULTINATIONAL sequence, which collates 
the international character set. When you use the MULTINATIONAL 
sequence, characters are ordered according to the following rules: 

• All diacritical forms of a character are given the collating value of the 
character (A',A",A' collate as A). 

• Lowercase characters are given the collating value of their uppercase 
equivalents (a collates as A, a" collates as A"). 

• If two strings compare as equal, tie-breaking is performed. The strings are 
compared to detect differences due to diacritical marks, ignored characters, 
or characters that collate as equal although they are actually different. If 
the strings still compare as equal, another comparison is done based on 
the numeric codes of the characters. In this final comparison, lowercase 
characters are ordered before uppercase. 

Care should be taken when sorting or merging files for further processing 
using the MULTINATIONAL sequence. Sequence checking procedures 
in most programming languages compare numeric characters. Because 
MULTINATIONAL is based on actual graphic characters, and not the codes 
representing those characters, normal sequence checking will not work. 

Note that some languages do not support MULTINATIONAL comparisons 
and instead can use the LIB$COMPARE_MULTI routine. 
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user-defined-sequence 

Specifies a user-defined collating sequence. Define a collating sequence by 
specifying a string of single or double characters or ranges of single characters. 
(A double character is any set of two single characters that are collated as if 
they were one character. For example, "CH" can be defined to collate as 
"C" .) This string should be enclosed in parentheses. 

You can also represent characters by their corresponding octal, decimal, or 
hexadecimal values, using the radix operators: %0, %D, %X. 

You must observe the following rules when defining your collating sequence: 

• Enclose characters in quotation marks. 

• Separate each character and character range by commas, and enclose the 
entire list in parentheses. 

• Give all the characters appearing in the character keys in the sort or merge 
operation a collating value. Any character not given a collating value will 
be ignored unless the FOLD or MODIFICATION options are specified. 

• Do not define a character more than once. 

• Do not specify the null character by using quotation marks (""). Instead, 
use a radix operator, such as %X0. 

• Specify quotation marks by enclosing them within another set of quotation 
marks (""""), or by using a radix operator. 

MODIFICA TION=(character operator character) 

Specifies a change to the collating sequence specified in the SEQUENCE 
option. You may modify the ASCII, EBCDIC, MULTINATIONAL, or user 
defined sequence. The sequence being modified must be specified in the 
SEQUENCE option of the clause, even if the sequence is the default (ASCII). 

character 

Specifies a character in the collating sequence. You can specify a single or 
double character. A double character is any set of two single characters that 
are collated as if it were a single character. Enclose the character in quotation 
marks. 

operator 

Specifies the operator used to compare the characters. You may specify 
greater than (> ), less than ( <), or equal to ( = ). 

The kinds of changes permitted in the MODIFICATION option are listed 
below: 

• A single or double character can be equated to a single character that has 
already been assigned a collating value ("a"="A"). 

• A single or double character can collate after a single character that has 
already been assigned a collating value ("CH"> "C"). 

• A single or double character can collate before a single character that has 
already been assigned a collating value ("D" <"A"). 

• A double character can be equated to a previously defined double 
character ("CH" = "SH"). 

• A single character can be equated to a double character sequence ("C" = 
"CH"). 
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IGNORE 

Specifies that SORT/MERGE ignore a character or character range in the 
collating sequence when making an initial comparison. Note that when 
tie-breaking takes place, SORT/MERGE considers the character(s) specified 
in the IGNORE clause. Tie-breaking takes place when two or more strings 
have compared as equal and the MULTINATIONAL sequence is being used, 
or when two or more strings have compared as equal and the TIE_BREAK 
clause has been specified. 

FOLD 

Specifies that all lowercase letters be given the collating value of their 
uppercase equivalents. For ASCII, EBCDIC, and user-defined sequences, 
the lowercase letters are a through z. 

Since the lowercase letters in the MULTINATIONAL sequence already 
have the collating value of their uppercase equivalents, the use of FOLD is 
unnecessary. 

[NOJTIE—BREAK 

Specifies whether or not SORT/MERGE should use numeric values to 
break any ties between characters that have equivalent values. By default, 
tie-breaking occurs with the MULTINATIONAL sequence. Specifying 
NOTIE—BREAK overrides this default and ensures that no further 
comparisons are made after the initial comparison. 

A TIE-BREAK option must be specified for the ASCCI, EBCDIC, and user 
defined sequences in order for tie-breaking to occur. TIE—BREAK should be 
used when specifying FOLD or MODIFICATION for the these sequences. 


DESCRIPTION The /COLLATING—SEQUENCE clause specifies the collating instructions for 

a sort or merge operation. In a /COLLATING—SEQUENCE clause, you can 
specify ASCII (the default), EBCDIC, or MULTINATIONAL sequence; you 
can also define your own sequence. 

In addition, the MODIFICATION, IGNORE, FOLD, and [NO]TIE_BREAK 
options of the /COLLATING—SEQUENCE clause can be used to modify any 
of these sequences. You can make more than one modification to the collating 
sequence. If you intend to modify any collating sequence, you must specify 
the sequence in the SEQUENCE option, even if it is the default sequence 
(ASCII). 

Because the FOLD, MODIFICATION, and IGNORE clauses are processed in 
the order in which they are specified, care should be taken when specifying 
the order of those clauses. Normally, FOLD should be specified after all 
MODIFICATION and IGNORE clauses to ensure that the effects of the 
MODIFICATION and IGNORE clauses apply to uppercase and lowercase 
characters. 

You can request that SORT/MERGE ignore a character or character range 
within the given collating sequence by using an IGNORE clause. 

By default in the MULTINATIONAL collating sequence, SORT/MERGE folds 
lowercase letters onto their uppercase equivalents. If you want this folding to 
occur in the other collating sequences, you must specify a FOLD clause with 
the instructions for the collating sequence. 
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Also, by default in the MULTINATIONAL collating sequence, SORT/MERGE 
uses numeric comparisons to break any ties in the collating values. Ties 
occur when two equal keys collate the same. If you do not want the default 
when using the MULTINATIONAL collating sequence, specify the keyword 
NOTIE—BREAK. For tie breaking in the other collating sequences, specify a 
TIE_BREAK clause. 


EXAMPLES 

Q /COLLATING_SEQUENCE=(SEQUENCE=ASCII,IGN0RE=("-"," ") 

This /COLLATING-SEQUENCE clause with an IGNORE option specified 
results in the following fields being compared as equal before tie breaking: 

252-3412 
252 3412 
2523412 


B 


E 


/COLLATING_SEQUENCE=(SEQUENCE=("A"-"L","LL","M"-"R"."RR","S"-"Z") ) 

This /COLLATING-SEQUENCE clause defines a sequence in which the 
double character LL collates as a single character between L and M, and the 
double character RR collates as a single character between R and S. These 
double characters would otherwise appear in their normal alphabetical order. 
By default, this user-defined sequence does not define any other characters, 
such as lowercase a through z. 

/COLLATING_SEQUENCE=(SEQUENCE= ! User-defined sequence 

("AN","EB","AR","PR","AY","UN","UL", ! that gives each month 

"UG","EP","CT","OV","EC", "0"-"9") , ! a unique value in its 

! chronological order 

MODIFICATIONS" ' " = "19") , 

FOLD) 

This /COLLATING-SEQUENCE clause defines a collating sequence that 
allows you to order a file SEMINAR.DAT according to the seminar date. The 
file SEMINAR.DAT is set up as follows: 


16 NOV 1983 
05 APR 1984 

11 Jan '84 

12 OCT 1983 
15 MAR 1984 
08 FEB 1984 
07 Dec '83 
14 SEP 1983 


Communication Skills 
Coping with Alcoholism 
How to Be Assertive 
Improving Productivity 
Living with Your Teenager 
Single Parenting 

Stress-Causes and Cures 

Time Management 


The primary key is the year field; the secondary key is the month field. 
Because the month field is not numeric and you want the months ordered 
chronologically, you must define your own collating sequence. You can 
do this by sorting on the second two letters of each month—in their 
chronological sequence—giving each month a unique key value. 

The MODIFICATION option specifies that the apostrophe (') be equated 
to 19, thereby allowing a comparision of '83 and 1984. The FOLD option 
specifies that uppper and lower case letters are treated as equal. 
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The output from this sort operation appears as follows: 


14 

SEP 

1983 

12 

OCT 

1983 

16 

NOV 

1983 

07 

Dec 

'83 

11 

Jan 

'84 

08 

FEB 

1984 

15 

MAR 

1984 

05 

APR 

1984 


Time Management 
Improving Productivity 
Communication Skills 

Stress-Causes and Cures 

How to Be Assertive 
Single Parenting 
Living with Your Teenager 
Coping with Alcoholism 
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/CONDITION 

Defines conditions for key and data handling and for record 
selection. 


FORMAT /CONDITION 

(NAME= condition-name, 

TEST= (field-name operator test-condition 
[logical-operator...])) 


qualifier values IMA ME=con dit ion-name 

Specifies the name of the condition you are testing. This condition-name may 
be used in /KEY, /DATA, /OMIT, and /INCLUDE clauses after it has been 
defined in the /CONDITION clause. 

TEST=(field-name operator test-condition) 

Specifies the conditional test. 

field-name 

Specifies the name of the field you are testing. The field-name must be 
defined previously in a /FIELD clause. 

operator 

Specifies the logical or relational operator used in the conditional test. The 
logical operators that you can use are AND and OR; the relational operators 
that you can specify are listed below. 


Operator Meaning 

EQ Equal to 

NE Not equal to 

GT Greater than 

GE Greater than or equal to 

LT Less than 

LE Less than or equal to 


test-condition 

Specifies the constant or field-name against which you are testing. A constant 
is specified with the following syntax: 


% Ddecimal_digi ts 
%Ooctal_digits 

%Xhexadecimal_digits 

"character" 


The field-name must be defined in a /FIELD clause. 


SORT-56 













SORT 

/CONDITION 


DESCRIPTION A specification file can be used to change the relative order of a record 

or to alter the contents of certain fields of a record. You must first use a 
/CONDITION clause to define a conditional test. Once you define a test in 
a /CONDITIONAL clause, you can use that same test in a /KEY or /DATA 
clause to change the order of record or in a /OMIT or /INCLUDE clause to 
change the contents of a record. 

If you want to change the order of records in the output file, you first specify 
a condition name in a /CONDITION clause and then you set up a test for 
what meets that condition. Then you would specify the relative order in a 
/KEY clause of the form: 

/KEY=(IF condition-name THEN value ELSE value) 

You can use any values to specify the relative order of the records. 

The /CONDITION clause also permits you to change the contents of a field 
in the output records. First specify a condition name, and then set up a test 
for what meets the condition. Specify the contents you want in the field in a 
/DATA clause of the form 

/DATA=(IF condition-name THEN "new-contents" ELSE "new-contents") 


EXAMPLES 

□ /FIELD=(NAME=AGENT.POSITION:20.SIZE:15) 

/C0NDITI0N=(NAME=AGENCY, 

TEST=(AGENT EQ "Real-T Trust" 

OR 

AGENT EQ "Realty Trust")) 

/DATA=(IF AGENCY THEN "Realty Trust" ELSE AGENT) 

In this example, two real estate files are being sorted. One file refers to an 
agency as Real-T Trust; the other refers to the same agency as Realty Trust. 
The /CONDITION and /DATA clauses instruct SORT to list the AGENT 
field in the sorted output file as Realty Trust. 

B /FIELD=(NAME=ZIP.POSITION:60.SIZE:6) 

/C0NDITI0N=(NAME=L0CATI0N, 

TEST=(ZIP EQ "01863")) 

/KEY=(IF LOCATION THEN 1 
ELSE 2) 

In this example, all the records with a zip code of 01863 will appear at the 
beginning of the sorted output file. The conditional test is on the ZIP field, 
defined in the /FIELD clause; the condition is named LOCATION. The values 
of 1 and 2 in this /KEY clause signify a relative order for those records that 
satisfy the condition and those that do not. 

0 /FIELD=(NAME=ZIP.POSITION:60.SIZE:6) 

/C0NDITI0N=(NAME=L0CATION. 

TEST=(ZIP EQ "01863")) 

/DATA=(IF LOCATION THEN "NORTH CHELMSFORD" 

ELSE "Outside district") 

In this example, the /CONDITION clause tests for the 01863 zip code. The 
/DATA clause specifies that the name of town field will be added to the 
output record, depending on the test results. 
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/DATA 

Specifies the fields of a record to be directed to the output file. 

FORMAT 

/DAT A =field-name 

/DATA =(7F condition-name THEN "new-contents" 
ELSE "new-contents") 

qualifier values 

field-name 

Specifies the name of a field in a record. The field-name must be defined 
previously in a /FIELD clause. 

condition-name 

Specifies a condition-name that has been defined previously in a 
/CONDITION clause. 

new-contents 

Specifies how the record is to be altered. The new-contents can be a constant 
or a field-name that has been defined in a /FIELD clause. 

DESCRIPTION 

A /DATA clause must identify every field in the records you are directing to 
the output file. Specify the data fields in the order in which you want them 
to appear in the output record. By default, the record format for an output 
file is the same as that for the input file. If you want to eliminate or reorder 
fields from the output record, you can use a /DATA clause. Only those fields 
identified in /DATA clauses will be directed to the output file. 

You can conditionally change the contents of a field in the output records by 
first specifying a condition name and then setting up a test for what meets the 
condition in a /CONDITION clause. You then specify the contents you want 
in the field in a /DATA clause of the form: 

/DATA=(IF condition-name THEN "new-contents" ELSE "new-contents") 

EXAMPLES 



Q /FIELD=(NAME=AGENT,POSITION:1,SIZE:5) 

/FIELD=(NAME=ZIP,POSITION:6.SIZE:3) 

/FIELD=(NAME=STYLE,POSITION:10,SIZE:5) 
/FIELD=(NAME=CONDITION,POSITION:16,SIZE:9) 
/FIELD=(NAME=PRICE,POSITION:26,SIZE:5) 
/FIELD=(NAME=TAXES,POSITION:32,SIZE:5) 
/DATA=PRICE 
/DATA=" " 

/DATA=TAXES 
/DATA=" " 

/DATA=STYLE 
/DATA=" " 

/DATA=ZIP 
/DATA=" " 

/DATA=AGENT 
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The /FIELD clauses define the fields in the records from an input file that has 
the following format: 

AGENT ZIP STYLE CONDITION PRICE TAXES 

The /DATA clauses, which use the field-names defined in the /FIELD 
clauses, reformat the records to create output records of the following format: 

PRICE TAXES STYLE ZIP AGENT 

0 /FIELD=(NAME=AGENT,POSITION:20,SIZE:15) 

/C0NDITI0N=(NAME=AGENCY, 

TEST=(AGENT EQ "Real-T Trust" 

OR 

AGENT EQ "Realty Trust")) 

/DATA=(IF AGENCY THEN "Realty Trust" ELSE AGENT) 

In this example, two real estate files are being sorted. One file refers to an 
agency as Real-T Trust; the other refers to the same agency as Realty Trust. 
The /CONDITION and /DATA clauses instruct SORT to list the AGENT 
field in the sorted output file as Realty Trust. 
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/FIELD 

FORMAT 

qualifier values 


Defines the fields in the input file(s). 


/FIE LD=(NAME=field-name, POSITION :n, S!ZE:n, 
[DIGITS: n,]data-type) 


NA ME=field-name 

Specifies the name of the field. The field name cannot have any embedded 
blanks, must begin with an alphabetic character, and can be no longer than 
31 characters. 

POSITION:n 

Specifies the position of the field in the record. 

SIZE:n 

Specifies the size of a field containing character or binary data. In the 
specification file, SIZE implies byte lengths. The data type determines what 
values are acceptable. 

• For character data, the size must not exceed 32,767 characters. 

• For binary data, the size specified must be 1, 2, 4, 8, or 16 bytes. 

• For floating-point data, no size must be specified. 


DIGITS.n 

Specifies the size of a field containing decimal data. The size of a field 
containing decimal data must not exceed 31 digits. Note that DIGITS.n is 
used only when describing a field containing decimal data. 

data-type 

Specifies the data type of the field. You are not required to specify the data 
type if it is character; SORT assumes character data type by default. The data 
types recognized by VAX/VMS SORT/MERGE are listed below. 

CHARACTER 

BINARY[,SIGNED] 

BINARY,UNSIGNED 

D_FLO ATIN G 

F_FLOATING 

G—FLOATING 

PL_FLOATING 

ZONED 

DECIMAL[,SIGNED,TRAILING_SIGN,OVERPUNCHED_SIGN] 

DECIMAL,LEADING_SIGN,SEPARATE_.SIGN[,SIGNED] 

DECIMAL,LEADING_SIGN,[OVERPUNCHED_SIGN,SIGNED] 

DECIMAL,[TRAILING_SIGN],SEPARATE_SIGN[,SIGNED] 

DECIMAL,UNSIGNED 

PACKED_DECIMAL 
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DESCRIPTION If you are altering the order or format of output records, you must identify 

each field of the records. These fields include key fields, fields to be 
compared, and fields to be directed to the output file. You identify each 
field by specifying a name, its position and size in the record, and its data 
type in the /FIELD clause. 

Once the field-name has been specified in the /FIELD clause, it can be used 
in the /CONDITION, /KEY, and /DATA clauses. 


EXAMPLE 


/FIELD=(NAME=SALARY,POSITION:10.DIGITS:8.DECIMAL) 

This /FIELD clause identifies a field in a record by the name SALARY, 
specifies that it starts in position 10 of the record, is 8 digits long, and consists 
of decimal data. 
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/INCLUDE 

Specifies record selection, as well as multiple record formats. 

FORMAT 

/\NCLUDE=(CONDITION=condition-name 
[, KEY=. ..][, DA TA=...]) 

qualifier values 

CONDITION=condition-name 

Refers to the condition-name specified in a previous /CONDITION clause. 

KEY=... 

Defines a key field because the default record type defined in the /KEY clause 
is not being used. 

DATA=... 

Defines a data field because the default record type defined in the /DATA 
clause is not being used. 

DESCRIPTION 

You can specify that records are to be conditionally included in an output 
file. After defining a condition in a /CONDITION clause, you specify record 
selection in a /INCLUDE clause that requests that records satisfying that 
condition are to be included in the output file. 

You can specify multiple /INCLUDE and /OMIT clauses in a specification 
file. The order in which you specify them determines the order in which 
the input records are tested for inclusion. After the last /INCLUDE clause, 
all records that have not already been included or explicitly omitted will be 
omitted. 

You can unconditionally include any records not previously omitted or 
included by specifying /INCLUDE without a condition. 

When sorting multiple record formats, one /INCLUDE clause should be 
specified for each different record format among the records to be sorted. If 
you do not specify a KEY option within the INCLUDE clause, SORT assumes 
the default key definitions. If the KEY is specified in the /INCLUDE clause, 
the default key definition(s) is not used. The order of the KEY field(s) in the 
/INCLUDE clause determines how the internal key is built for sorting. The 
order of the DATA field(s) in the /INCLUDE clause determines the way in 
which the output record is formatted. If you specify a key or data field in an 
/INCLUDE clause, you must define all other key or data fields in the record. 

See the Specification File Example Section for an example of a sort of records 
with two different formats. 
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EXAMPLE 


/FIELD=(NAME=ZIP,POSITION:20,SIZE:6) 

/C0NDITI0N=(NAME=LOCATION, 

TEST=(ZIP EQ "01863")) 

/INCLUDE=(CONDITION=LOCATION) 

These /CONDITION and /INCLUDE clauses specify that records with the 
zip code 01863 will be included in the output file. 
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/KEY 


Specifies the key field(s). 


FORMAT /KEY =field-name 

/KEY=(field-name, order) 

/KEY=([IFcondition-name THEN value ELSE] ... value 
[, order]) 


qualifier values field-name 

Specifies the name of the key field. The field-name has been previously 
specified in a /FIELD clause. 

order 

Specifies the order of the sort. The ASCENDING option specifies ascending 
order for a sort or merge operation. This option is the default. The 
DESCENDING option specifies descending order for a sort or merge 
operation. 

value 

Specifies the key. The value can be a constant or a field-name that has been 
defined in a /FIELD clause. 


DESCRIPTION If you are sorting on the entire record using character data, there is no need 

to specify your key field. Otherwise, you must specify a /KEY clause for each 
of the keys, in the order of their priority. You can sort on as many as 255 
key fields. There are three ways to use the /KEY clause. First, you may use 
the /KEY clause simply to identify the key field-name. Secondly, you may 
use the /KEY clause to identify the key field-name and to specify sorting 
order. In this case, you must enclose the field-name and the order option in 
parenthesis. 

Finally, you can use a conditional /KEY clause to change the order of records 
in the output file. You first specify a condition name in a /CONDITION 
clause and then you set up a test for what meets that condition. Then you 
specify the relative order in a /KEY clause of the form: 

/KEY=(IF condition-name THEN value ELSE value) 

You can use any values to specify the relative order of the records. 


EXAMPLES 

□ /FIELD=(NAME=SALARY,POSITION:10.DIGITS:8.DECIMAL) 

/KEY=(SALARY.DESCENDING) 

This /KEY clause specifies that the key field is SALARY, and that the sorting 
order is descending. 
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/FIELD=(NAME=ZIP,POSITION:20,SIZE:6) 

/C0NDITI0N=(NAME=L0CATI0N, 

TEST=(ZIP EQ ''01863'')) 

/KEY=(IF LOCATION THEN 1 
ELSE 2) 

In this example, all the records with a zip code of 01863 will appear at the 
beginning of the sorted output file. The conditional test LOCATION (defined 
in a /CONDITION clause) is on the ZIP field (named in a /FIELD clause). 
The values of 1 and 2 in this /KEY clause signify a relative order for those 
records that satisfy the condition and those that do not. 
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/OMIT 

Specifies record selection as well as multiple record formats. 

FORMAT 

/OMlT=(CONDITION=condition-name) 

qualifier value 

CONDITIONcondition-name 

Refers to the condition-name previously specified in a /CONDITION clause. 

DESCRIPTION 

You can specify that records are to be omitted from the output file by the use 
of an /OMIT clause. First, you must define a condition with a /CONDITION 
clause. You specify your record selection with an /OMIT clause that requests 
that records satisfying that condition be selected for omission from your sort. 
By default, SORT/MERGE will include all the other input records in the 
output file. 

You can specify multiple /OMIT and /INCLUDE clauses in your specification 
file. The order in which you specify them determines the order in which the 
input records are tested for omission. All the records that have not already 
been included or omitted after the last /OMIT clause will be included. You 
can unconditionally omit any records not previously omitted or included by 
specifying /OMIT only. 


EXAMPLE 

/FIELD=(NAME=ZIP.POSITION:20,SIZE:6) 

/C0NDITI0N=(NAME=LOCATION, 

TEST=(ZIP EQ "01863")) 

/OMIT=(CONDITION=LOCATION) 

These /CONDITION and /OMIT clauses specify that records with the zip 
code 01863 will not be included in your output file. 
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/PAD 

Allows you to specify a pad character to use when reformatting 
records or when comparing strings of unequal length. 

FORMAT 

/PAD=single-character 

qualifier value 

single-character 

Specifies the character SORT will use to pad a string. Characters, decimal, 
octal, or hexadecimal digits may be used. The pad character should be 
specified as follows: 

• Use quotation marks for a character— 

• Use decimal radix for decimal digits—%D35 

• Use octal radix for octal digits—%O043 

• Use hexadecimal radix for hexadecimal digits—%X23 

DESCRIPTION 

Use the /PAD clause to specifiy a pad character when comparing strings of 
unequal length or when reformatting records. By default, SORT uses the 
null character for padding, ensuring conformity with the previous versions. 
Double characters that can be defined as single characters ("ch" > "c" ) 
cannot be used as pad characters. 

EXAMPLE 


/PAD="." 

This /PAD clause specifies that records will be padded with periods. 
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/PROCESS 

Defines the processing method for the sorting operation (SORT 



only). 

FORMAT 

/PROCESS=fype 

qualifier values 

RECORD 

Specifies the record sort. This SORT process is the default. 

TAG 

Specifies the tag sort. 

ADDRESS 

Specifies the address sort. 

INDEX 

Specifies the index sort. 

DESCRIPTION 

By default, SORT uses a record sorting process. You may also specify a 
tag, address, or index sorting process. If you intend to reformat the output 
records, you cannot use address or index sort. For a comparison of the four 
processes, see the description of /PROCESS in the Command Qualifiers 
Section. Use the /PROCESS clause with SORT only. 

EXAMPLE 


/PROCESS=tag 

This /PROCESS clause specifies that SORT use a tag sorting process. 
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/STABLE 

Specifies that records with equal keys are directed to the output file 
in their input file order. The default condition is /NOSTABLE. 

FORMAT 

/[NO]STABLE 

DESCRIPTION 

By default, the order of output records with equal keys is unpredictable. 
Specifying the /STABLE clause in a specification file arranges records with 
equal keys in the output file in the order of the input files as specified in the 
command line. If you use this qualifier when sorting multiple input files, on 
output, records with equal keys in the first file will precede those from the 
second file and so on. 

EXAMPLE 


/STABLE 

This /STABLE clause ensures that records with equal keys will have the same 
order in the input and output files. 
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/WORK_FILES 

Specifies the reassignment of work files 


FORMAT 

/WORK_FILES=fc/ewce ^...]) 

qualifier value 

device 

Specifies a logical name for the work file. Unlike the DCL qualifier 
/WORK_FILES=n, the specification file clause /WORK__FILES=(device[,...]) 
specifies work file assignments, not the number of work files. 

DESCRIPTION 

You can improve the performance of SORT by placing work files on different 
disk-structured devices. Using the /WORK__FILES clause in a specification 
file to reassign work files makes it unnecessary to make logical assignments 
prior to invoking SORT at the command or program level. 

For more information on reassigning work files, see the Description Section. 

EXAMPLE 


/WORK_FILES=("WRKD$:") 

This /WORK_FILES clause assigns one of SORT'S work files to the device, 
WRKD$: because that device has the most space available. 
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SORT 

Examples 


SPECIFICATION 

FILE 

EXAMPLE 


/FIELD=(NAME=RECORD_TYPE.PO:1,SIZ:1) 

/FIELD=(NAME=PRICE,PO:2,SIZ:8) 

/FIELD=(NAME=TAXES,PO:10,SIZ:5) 

/FIELD=(NAME=STYLE_A,PO:15,SIZ:10) 

/FIELD=(NAME=STYLE_B,PO:20,SIZ:10) 

/FIELD=(NAME=ZIP_A,PO:25,SIZ:5) 

/FIELD=(NAME=ZIP_B,PO:15,SIZ:5) 

/CONDITION=(NAME=FORMAT_A, 

TEST=(RECORD_TYPE EQ "A")) 

/CONDITION ( N AME=FORMAT_B, 

TEST=(RECORD_TYPE EQ "B")) 

/INCLUDE^(CONDITION=FORMAT_A, 

KEY=ZIP_A, 

DATA=PRICE, 

DATA=TAXES. 

DATA=STYLE_A, 

DATA=ZIP_A) 

/INCLUDE=(CONDITION=FORMAT_B, 

KEY=ZIP_B, 

DATA=PRICE, 

DATA=TAXES. 

DATA=STYLE_B, 

DATA=ZIP_B) 

In this example, two input files from two different branches of a real estate 
agency are sorted according to the instructions specified in a specification file. 
The records in the first file that begin with an "A" in the first position have 
this format: 

IAI PRICE I TAXES I STYLE I ZIP I 
12 10 15 25 

The records in the second file that begin with a "B" in the first position and 
have the style and zip code fields reversed, as follows: 

IBI PRICE I TAXES I ZIP I STYLE I 
12 10 15 20 

To sort these two files on the zip code field in the format of record A, you first 
define the fields in both records with the /FIELD clauses. Then you specify a 
test to distinguish between the two types of records with the /CONDITION 
clauses. Finally, the /INCLUDE clauses change the record format of type B 
to record format of type A on output. 

Note that, if you specify either key or data fields in an /INCLUDE clause, 
you must explicitly specify all the key and data fields for the sort operation in 
the /INCLUDE clause. 

Also note that records that are not type A or type B are omitted from the sort. 


! Record's type, one-byte field 
! Price field, both files 
! Taxes field, both files 
! Style field, format A file 
! Style field, format B file 
! Zip code field, format A file 
! Zip code field, format B file 

! Condition test, format A file 
! Condition test, format B file 

! Output format, type-A records 


! Output format, type-B records 
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READER'S Note: This form is for document comments only. DIGITAL will use comments 
COMMENTS submitted on this form at the company's discretion. If you require a written reply 
and are eligible to receive one under Software Performance Report (SPR) service, 
submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well organized? Please make suggestions for 
improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 
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□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 
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